Skip to main content
POST
Upload a media file

Authorizations

Authorization
string
header
required

Bearer authentication. Pass the access token in the Authorization: Bearer <token> header.

Body

multipart/form-data
cdn_host
string
required

CDN base URL.

file
file
required

Media file to upload.

file_size
integer
required

File size in bytes.

height
integer
required

Media height in pixels.

mime
string
required

MIME type (e.g. image/png, video/mp4).

owner_id
string<uuid>
required

Owner ID of the media asset.

storage
string
required

Storage type (fs or aws).

width
integer
required

Media width in pixels.

Response

Successful Response

cdn_path
string
required

CDN access URL

created_at
string<date-time>
required
file_size
integer
required

File size (bytes)

filename
string
required

File name

height
integer
required

Media height (px)

mime
string
required

MIME type

no
integer
required

Media library entry number

path
string
required

File path in storage

storage
string
required

Storage type (fs or aws)

updated_at
string<date-time>
required
user_id
string<uuid>
required

Media library owner ID

width
integer
required

Media width (px)